home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / BARNET / FREENET / MCEVOY / MAPSERV1 / Help next >
Text File  |  1996-02-09  |  4KB  |  84 lines
  1. MapServer v1.01
  2. Sun 04th February 1996
  3.  
  4.         ImageMap Server for use with HTTP Server
  5.         ========================================
  6.         
  7. Disclaimer
  8. ==========
  9. General principals:
  10.     If it works, it's my doing.
  11.     If it doesn't work it's not.
  12.     Use it at your own risk, and please report compliments, bugs and
  13. suggestions to me by e-mail, or I won't find out, 'cos I'm on a dial-up
  14. connexion :-(
  15.  
  16. Aim
  17. ===
  18. To live up to my own claim that my last program (!MapReader) would serve
  19. documents to remote machines, which it could never do! In a more positive
  20. vein, this program provides an easy graphical method for setting up links for
  21. ISMAP graphics, disposing of the need to use coordinate-based descriptions of
  22. the 'active areas' and making irregular active areas as easy as rectangles. 
  23. This is, I think, quicker and easier than the 'standard' methods available.
  24. Furthermore, the program acts as a server for locally-based html files, thus
  25. allowing a much quicker response time than the usual two part method.  In
  26. this version, the previous problem with links from locally server documents
  27. has, I hope, been solved.
  28.  
  29. Getting it to work
  30. ==================
  31.  
  32. Will work only in conjunction with Stuart Brodie's HTTP Server v1.3 (or,
  33. presumably later) MapServer must live in a subdirectory of cgi-bin, which
  34. must be in the base directory served to HTTP clients.  There may be as many
  35. levels of subdirectory beyond cgi-bin as you wish; there must be a separate
  36. directory for each imagemap. Each subdirectory must contain a copy of
  37. MapServer, a sprite file called Image and a text file called Index.
  38.  
  39.     MapServer works by using an index image to decode the coordinates
  40. passed to it in a system variable by HTTP Server. The index is a 256 colour
  41. sprite called 'image' and saved in the same directory as MapServer as Image.
  42. This is a copy of the source of the map, coloured to define the areas that
  43. are to act as anchors.  The index image MUST be scaled to the same size as
  44. the pixel dimensions of the rendered map - load it into ArcWeb as an ISMAP
  45. image and point to the bottom right-hand corner to find the dimensions. 
  46. However, I advise against scaling the image before colouring it, as so much
  47. definition can be lost as to make it rather difficult to see what one is
  48. doing.
  49.  
  50.     Next, colour 'sensitive' areas of the index image, noting the number
  51. of the colour as displayed by the !Paint large colours chooser.  Each colour
  52. may be linked to a separate URL, and if anyone needs more than 254 links per
  53. document, they are in a different league from me!
  54.     Now, scale the sprite down so that it is within a pixel-or-two of the
  55. correct dimensions, and flip it upside-down.  It's not my fault that sprites'
  56. origins are bottom-left and ImageMaps' are top-left :-(  Finally save the
  57. image.
  58.  
  59.     Now generate a text index file.  Each line must begin with two or
  60. three numbers (ie. 00, 04, 123) followed by a space, followed by a
  61. fully-qualified URL or a full pathname, followed by a return code.  The file
  62. should finish with a return code.  This should be saved as a text file called
  63. Index in the same directory as MapServer.
  64.     At the moment, the only URL methods supported are http: and local:,
  65. and it appears that these are the only ones that will work anyway (certainly
  66. I have been unable to make the mailto: method work). local: methods serve
  67. exactly the same function as a fully qualified pathname - both types are
  68. assumed to be html source code and are served directly to the remote machine. 
  69. Any filetype other than html *MUST* be specified by the http: method.
  70.  
  71.     You may also include a FIRST line beginning 'default ' and containing
  72. a fully-qualified http: method URL to a document that you want to be
  73. displayed when there is no link specified in the rest of the index file. 
  74. This will usually be the source document.
  75.  
  76.     I hope that this satisfies the desires of all you lucky Acorn owners
  77. out there who have Ethernet connexions and wish to serve imagemaps to your
  78. adoring public.  And NO! I'm not at all jealous of you!
  79.     
  80.                     Charles McEvoy
  81.                     Cambridge Sun 04th February 1996
  82. NB New to v1.01
  83.    Reverse DNS lookup implemented so the the base address passed with locally served
  84. documents is, if possible, the name rather than the address of the server.